home *** CD-ROM | disk | FTP | other *** search
/ Super Shareware Collection / Super Shareware Collection.iso / os_2 / gusmixer.zip / GUSMIXER.TXT < prev    next >
Text File  |  1994-02-06  |  8KB  |  164 lines
  1. ================================================================================
  2.                      Gravis Ultrasound Mixer (for OS/2 2.x)
  3.                              Freeware, Version 1.0
  4.  
  5.                             (c) 1994, Robert Turner
  6.                       rdturner@undergrad.math.uwaterloo.ca
  7. ================================================================================
  8.  
  9. DESCRIPTION:
  10.  
  11.       This is a simple line mixer for the Gravis Ultrasound.  It allows the
  12. user to enable and disable the input and output lines on their Ultrasound card.
  13. It requires OS/2 2.x (with Presentation Manager installed) to run.
  14.  
  15. This product is intended to hold over until MMPM drivers for the Ultrasound
  16. arrive.  It may then be upgraded to work with those drivers.
  17.  
  18. This software is *FREE*.  The author can be contacted at the above Internet
  19. electronic mail address for at least the next year.  Comments, bug reports, and
  20. suggestions are all welcome.
  21.  
  22. I hope this proves useful to someone other than myself.
  23.  
  24.  
  25. DISCLAIMER: (Just in case someone thinks about sueing me for something...)
  26.  
  27.       THE AUTHOR (ROBERT TURNER) PROVIDES NO GUARRENTEE THAT THIS SOFTWARE
  28. WILL PERFORM AS DESCRIBED, ALTHOUGH EVERY ATTEMPT HAS BEEN MADE TO ENSURE THAT
  29. IS DOES.  THE AUTHOR ALSO WARNS THAT IMPROPER USE OF THIS SOFTWARE, CAUSED BY
  30. SETTING UP THE OPTIONS INCORRECTLY, OR BY HAVING INCOMPATIBLE HARDWARE, MAY CAUSE
  31. MALFUNCTIONS, AND POSSIBLY DAMAGE (ALTHOUGH HE HOPES NOT) TO THE USER'S HARDWARE.
  32. BY USING THIS SOFTWARE, IT IS UNDERSTOOD THAT THE USER UNDERSTANDS THAT HE/SHE
  33. UNDERTAKES COMPLETE RESPONSABILITY FOR WHATEVER HAPPENS THROUGH USE OF THIS
  34. SOFTWARE, BE IT BENEFICIAL OR DETREMENTARY.
  35.  
  36.  
  37. INSTALLATION:
  38.  
  39.       Copy the GUSMixer.EXE file into a directory or your choice.  You may want
  40. to put it in a directory on your path.  You can add it to your startup folder or
  41. your CONFIG.SYS file so that is gets run every time you start your system.
  42.  
  43.       Before playing with the line settings, select "Options..." from the system
  44. menu of the GUSMixer window, and make sure that the "Port" setting corresponds to
  45. the I/O port where your Ultrasound card is located.
  46.  
  47.  
  48. USAGE:
  49.  
  50.       The program is fairly self explanatory.  The main window contains three check
  51. boxes which correspond to the outputs and inputs on the back of the Ultrasound card.
  52.  
  53.      "Line Out"     When checked, enables output to the line out jack, and the
  54.                     headphone out jack.
  55.      "Line In"      When checked, enables input to the Ultrasound from the line
  56.                     in input.
  57.      "Mic. In"      When checked, enables input to the Ultrasound from the 
  58.                     Microphone input.
  59.  
  60. The check boxes can be in three states.  Normally you will only see the two 
  61. determinate states, checked and unchecked.  These correspond to the lines being
  62. enabled and disabled respectively.  The other state is the grayed sate for the check
  63. box.  This indicates the GUSMixer does not know what state the line is in.  (NOTE:
  64. The Ultrasound does not allow querying of the line states, so until you set them to
  65. something, they will be indeterminate.)
  66.  
  67.       Two extra menu items are attached to the system menu, 'Options..." and
  68. "Product Information...".
  69.  
  70.  
  71. OPTIONS
  72.  
  73.       Restore Window Position on Startup
  74.  
  75.           If this option is set, when GUSMixer starts, it will restore the window
  76.           to the last saved position.  If the window was minimized, this state will
  77.           be preserved.  The window position is saved when you press "Save Now", or
  78.           if "Save Options on Exit" is set, when GUSMixer terminates.
  79.  
  80.       Save Options on Exit
  81.  
  82.           If this option is set, the options displayed in this window will be 
  83.           saved.  Options are saved in the OS2.INI file.
  84.  
  85.       Port
  86.  
  87.           This specifies the I/O port where your Ultrasound is located.  Currently
  88.           GUSMixer does not attempt to locate the Ultrasound, and hence requires
  89.           the user to set this variable.  The default is 0x220.  The user should
  90.           ensure that this is set up correctly before trying to change the line
  91.           settings.
  92.  
  93.       Set Lines on Startup
  94.  
  95.           If this option is set, when GUSMixer starts, it will set the Ultrasound
  96.           input/output lines to reflect the "Initial Line Settings".
  97.  
  98.         Initial Line Settings            
  99.           Line Out    \
  100.           Line In        >  These are the same as in the main window.  Except that
  101.           Mic. In       /   you cannot leave the line in an indeterminate state.
  102.  
  103.       Save now
  104.  
  105.           Saves the current settings.  Useful if you don't want to save settings 
  106.           every time you close GUSMixer (or shut down you system with it running).
  107.  
  108.  
  109. COMMAND LINE OPTIONS
  110.  
  111.      The command line options always override the saved settings.  So if you've
  112. got the port saved wrong, or you're having problems, you can use these to force
  113. a known state.  All options must be specified separately (sorry...), ie.
  114.     -l -o -i -s  
  115. instead of
  116.     -lois
  117. If any parameters are invalid, they are ignored and no error is reported.
  118. Parameters may be specified in any order.  Parameters are processed in the
  119. order they are specified, and the last occurance of the parameter is the one
  120. that takes effect.  The parameters all correspond (with the exception of "-i")
  121. to options in the "Options" window.
  122.  
  123.      -pNNNNN     Port:      Replace NNNNN with the port number, valid choices
  124.                             are: 0x210, 0x220, 0x230, 0x240, 0x250, 0x260.
  125.  
  126.      -o[0|1]     Line Out:  Enables ("1") or disables ("0") the line out.  Defaults
  127.                             to enable if "0" or "1" not specified.  Note that for
  128.                             the line to actually be enabled or disables, the "-s"
  129.                             option must also be specified.
  130.  
  131.      -l[0|1]     Line In:   Enables ("1") or disables ("0") the line in.  Defaults
  132.                             to enable if "0" or "1" not specified.  Note that for
  133.                             the line to actually be enabled or disables, the "-s"
  134.                             option must also be specified.
  135.  
  136.      -m[0|1]     Mic. In:   Enables ("1") or disables ("0") the microphone in.
  137.                             Defaults to enable if "0" or "1" not specified.  Note 
  138.                             that for the line to actually be enabled or disables,
  139.                             the "-s" option must also be specified.
  140.  
  141.      -i[0|1]     Iconic:    Minimizes ("1") or Restores ("0") the window.  Defaults
  142.                             to Minimize if "0" or "1" not specified.  Note that the
  143.                             "-r" option must be specified for this option to take
  144.                             effect.
  145.  
  146.      -r[0|1]     Restore:   Restores the window settings to the saved or overridden
  147.                             ones.
  148.  
  149.      -s[0|1]     Set Lines: Sets the Ultrasound input and output lines to the
  150.                             saved or overidden settings.
  151.  
  152.  
  153. OTHER PEOPLES TRADEMARKS AND COPYRIGHTS
  154.  
  155. (These are not quite exact, but are intended to give an idea who owns what.)
  156.  
  157.      Gravis, and Gravis Ultrasound are either registered trademarks, or 
  158.      copyrighted names of Advanced Gravis or Forte.
  159.      All rights reserved.
  160.  
  161.      OS/2 and Presentation Manager are either registered trademarks, or
  162.      copyrighted names of International Buisiness Machines Corp.
  163.      All rights reserved.
  164.